# Get Charge

Retrieve a charge by its ID

Endpoint: GET /v1/charges/{charge_id}
Version: v1

## Path parameters:

  - `charge_id` (string, required)
    Unique identifier for the charge

## Response 200:

  - `200` (unknown)
    Charge retrieved successfully

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for the charge
    Example: ch_01j8emz8chfxbb2bqmtref8ch7

  - `merchant` (object, required)

  - `merchant.id` (string, required)
    Unique identifier for the merchant
    Example: merchant_02c7h71rf3eg396idngupsr66t

  - `merchant.gateway_merchant_id` (string)
    Unique identifier for the merchant in the payment gateway
    Example: cs32cvc4i4783pdn9ml1

  - `merchant.api_key` (string)
    Secret API key for the merchant
    Example: api_2y46nIaf2xjtD0B74aZ6oxhQRxL

  - `merchant.pub_api_key` (string)
    Public API key for the merchant
    Example: pub_2y46nKsfnVmYQ7Fw6FTOhvS9l0F

  - `merchant.processors` (array)
    Merchant processors

  - `merchant.processors.id` (string, required)
    Unique identifier for the processor
    Example: cs32cvn0i4793pdn9mog

  - `merchant.processors.processor_type` (string, required)
    Enum: "ACH", "CREDIT_CARD"

  - `payment_type` (string, required)
    Type of payment for the charge
    Example: MANUAL

  - `status` (string, required)
    status of the charge
    Enum: "AUTHORIZED", "SETTLED"

  - `requested_amount` (integer, required)
    Requested amount for the charge
    Example: 100

  - `amount_authorized` (integer, required)
    Amount authorized for the charge
    Example: 100

  - `amount_captured` (integer, required)
    Amount captured for the charge
    Example: 100

  - `tip` (integer, required)
    Tip amount for the charge
    Example: 1

  - `tax` (integer, required)
    Tax amount for the charge
    Example: 10

  - `card_last_4` (string)
    Last 4 digits of the card used for the charge
    Example: 1234

  - `card_brand` (string)
    Brand of the card used for the charge
    Example: VISA

  - `created_at` (integer, required)
    Timestamp when the charge was created
    Example: 1727875117482

  - `authorized_at` (integer)
    Timestamp when the charge was authorized
    Example: 1727875117482

  - `captured_at` (integer)
    Timestamp when the charge was captured
    Example: 1727875117482

  - `settled_at` (integer)
    Timestamp when the charge was settled
    Example: 1727875117482

  - `card_entry_method` (string, required)
    Method used for card entry
    Enum: "SWIPE", "CHIP", "MANUAL"

  - `billing_address` (object)
    Billing address details

  - `billing_address.company` (string)
    Company name associated with the address
    Example: Acme Corp

  - `billing_address.phone` (string, required)
    Phone number associated with the address
    Example: +1234567890

  - `billing_address.email` (string, required)
    Email address associated with the address
    Example: example@domain.com

  - `billing_address.first_name` (string)
    First name of the person associated with the address
    Example: John

  - `billing_address.last_name` (string)
    Last name of the person associated with the address
    Example: Doe

  - `billing_address.address_line_1` (string)
    First line of the address
    Example: 123

  - `billing_address.address_line_2` (string)
    Second line of the address
    Example: Apt 4B

  - `billing_address.city` (string)
    City of the address
    Example: New York

  - `billing_address.state` (string)
    State of the address
    Example: NY

  - `billing_address.postal_code` (string)
    Postal code of the address
    Example: 10001

  - `billing_address.country` (string)
    Country of the address
    Example: USA

  - `billing_address.fax` (string)
    Fax number associated with the address
    Example: +1234567890

  - `card_expiration_date` (string)
    Expiration date of the card
    Example: 01/27

  - `card_type` (string)
    Type of the card
    Example: debit

  - `failure_reason` (string)
    Reason for the charge failure
    Example: Card declined

  - `refunds` (array)
    List of refunds associated with this charge

  - `refunds.id` (string, required)
    Unique identifier for the refund
    Example: re_01j8emz8chfxbb2bqmtref8ch7

  - `refunds.charge_id` (string, required)
    Unique identifier for the charge
    Example: ch_01j8emz8chfxbb2bqmtref8ch7

  - `refunds.merchant_id` (string, required)
    Unique identifier for the merchant
    Example: merchant_02c7h71rf3eg396idngupsr66t

  - `refunds.amount` (integer, required)
    Amount of the refund
    Example: 100

  - `refunds.created_at` (integer, required)
    Timestamp in milliseconds when the refund was created
    Example: 1727875117482

## Response 404:

  - `404` (unknown)
    Charge not found